home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga3 / oprefs20.lha / OberonPrefsOberonPrefs.dok < prev    next >
Text File  |  1993-10-20  |  38KB  |  887 lines
  1.  
  2.              ------------------------------------------------
  3.              OberonPrefs 2.0 (8.10.93) ⌐ F.Schwarz - Giftware
  4.              ------------------------------------------------
  5.  
  6.                   Voreinsteller-Programm fⁿr Amiga-Oberon
  7.  
  8.                          ⌐ 1993 & geschrieben von
  9.                                Franz Schwarz
  10.                     Mⁿhlenstra▀e 2, D-78591 Durchhausen,
  11.                               BR Deutschland
  12.                     Uucp: Franz_Schwarz@mil.ka.sub.org
  13.                     Fido: 2:2476/506.18 & 2:241/7506.18
  14.  
  15.                GUI erstellt mit Hilfe von GadToolsBox 37.176
  16.  
  17.            OberonPrefs ist Giftware; d.h. Sie werden ermuntert,
  18.            dem Autor ein kleines Geschenk, Geld, eine Postkarte,
  19.             o.Σ. zu schicken, falls Sie das Programm verwenden.
  20.  
  21.  
  22.  
  23.                               Aus dem Inhalt
  24.                               --------------
  25.  
  26.                 ▄berblick ⁿber das Konzept von OberonPrefs
  27.  
  28.                            Installationshinweise
  29.  
  30.               Die interaktive grafische Benutzerschnittstelle
  31.                  -Gadgets
  32.                  -Menⁿs
  33.                  -Piktogramm-Ziehen ins Fenster
  34.  
  35.                   Kommandozeilen- und ToolTypes-Argumente
  36.                      -Die Argument-Schablone
  37.                      -Die Argumente im einzelnen
  38.                      -Benutzerdefinierbare interaktive 
  39.                         Argument-Abfrage beim WB-Start
  40.  
  41.                        Programmende & Rⁿckgabewerte
  42.   
  43.                      Allgemeine Hinweise zum Programm
  44.   
  45.                  Vermeiden des VerΣnderns des Quelltextes 
  46.                  d.h. Anlegen/─ndern der OPREFS-Kopfzeile
  47.    
  48.                          Entwicklungsgeschichte  
  49.   
  50.                              Schlu▀bemerkungen
  51.   
  52.                             Adresse des Autors
  53.   
  54.                            Credits, Danksagungen
  55.   
  56.                         Die CygnusEd-ARexx-Skripte
  57.  
  58.  
  59.  
  60.                 ▄berblick ⁿber das Konzept von OberonPrefs
  61.                 ------------------------------------------
  62.  
  63.  
  64. OberonPrefs ist die ErgΣnzung zum Amiga-Oberon-System, auf die Sie bestimmt
  65. schon lange gewartet haben:  Ein Σu▀erst flexibles, universelles,
  66. intuitives Voreinsteller-Programm (Preferences-Editor), das neben einer
  67. komfortablen grafischen BenutzeroberflΣche auch eine durchdachte
  68. Shell-Schnittstelle (die im ⁿbrigen im vollen Umfang auch ⁿber
  69. Workbench-ToolTypes erreicht werden kann) und die Anpassung an
  70. verschiedene Landessprachen in Verbindung mit Commodore's locale.library ab
  71. Workbench 2.1 aufwΣrts bietet.
  72.  
  73.  
  74. Exkurs: Wie das Amiga-Oberon-System die Optionen einlie▀t:
  75.     
  76.   Da im Handbuch nur unvollstΣndig wiedergegeben wird, wie Amiga-Oberon/
  77.   -OLink/ -OMake die aktuellen Compiler-/ Linker-Optionen bestimmen, hier
  78.   die genaue Vorgehensweise:
  79.   
  80.   Zuerst werden die Programm-internen vorgegegebenen ('default') Optionen
  81.   herangezogen.  
  82.   
  83.   Diese Optionen werden durch eventuell in der Kommandozeile
  84.   spezifizierten Optionen -respektive durch die Workbench-ToolTypes des
  85.   aufgerufenen Werkzeugs (Oberon, OLink, OMake)- ⁿberschrieben.
  86.   
  87.   Danach ersetzen Optionen aus den m÷glicherweise vorhandenen
  88.   Voreinstellungsdateien Oberon.prefs und und OLink.prefs im Verzeichnis des
  89.   zu bearbeitenden Projektes die bisherigen Optionen.
  90.   
  91.   Schlie▀lich, falls die jeweilige Voreinstellungsdatei Oberon.prefs bzw.
  92.   OLink.prefs im Verzeichnis des zu bearbeitenden Projekts nicht gefunden
  93.   wurde, diese Voreinstellungsdatei jedoch im globalen Verzeichnis OBERON:
  94.   zu finden ist, treten die Optionen aus dieser Datei an Stelle der
  95.   bisherigen Optionen.
  96.  
  97.  
  98.  
  99. Um nun auf die unterschiedlichen Vorlieben und Konfigurationen der Anwender
  100. des Amiga-Oberon-Systems eingehen zu k÷nnen, besitzt OberonPrefs die
  101. M÷glichkeit, die Art, wie es die Optionen einlie▀t und schreibt,
  102. weitestgehend dem Benutzer zu ⁿberlassen.  Diese Einstellungen k÷nnen
  103. selbstverstΣndlich ⁿber Kommandozeilen-/ ToolTypes-Parameter angegeben
  104. werden, als auch als globale Einstellungen gespeichert und im interaktiven
  105. Modus geΣndert werden.
  106.  
  107.  
  108. OberonPrefs kennt grundsΣtzlich zwei verschiedene Betriebsmodi:  einen
  109. globalen Modus, in dem die globalen Voreinstellungen verΣndert werden, und
  110. einen Projekt-Modus, in dem die Voreinstellungen der verschiedenen Projekte
  111. und / oder einzelnen Oberon-Quelltext-Module verΣndert werden.
  112. SelbstverstΣndlich besteht dabei die M÷glichkeit des gegenseitigen Imports
  113. bzw. Exports der Voreinstellungen zwischen diesen Modi.
  114.  
  115.  
  116. OberonPrefs bietet die M÷glichkeit, alle gegenwΣrtig (Amiga-Oberon 3.00)
  117. bekannten Compiler- und Linker-Optionen zu manipulieren - im Projektmodus
  118. auch diejenigen, die nur im Oberon-Quelltext-Modul angegeben werden k÷nnen,
  119. aber gew÷hnlich fⁿr ein ganzes Modul gelten (CodeChip, VarsChip, DataChip,
  120. Implementation).
  121.  
  122.  
  123. Da die Benutzerschnittstellen (Interaktive grafische Schnittstelle,
  124. Kommandozeilen-Schnittstelle und Workbench-ToolTypes-Schnittstelle) von
  125. OberonPrefs so gestaltet wurden, da▀ sie den Richtlinien aus dem 'Amiga
  126. User Interface Style Guide' fⁿr Voreinsteller-Programme weitestm÷glich
  127. entsprechen, sollte die Bedienung fⁿr den mit Amiga-Voreinsteller-
  128. Programmen (z.B.  denjenigen, die zum Lieferumfang des Betriebssystems
  129. im Verzeichnis System:Prefs geh÷ren) vertrauten Benutzer ziemlich intuitiv
  130. sein.  Unbekannt an der interaktiven grafischen Benutzerschnittstelle
  131. dⁿrften jedoch das Konzept der zwei Operations-Modi (Global / Projekt) und
  132. die vielfΣltigen Einstellungsm÷glichkeiten im Einstellungen-Menⁿ sein.  Die
  133. Kommandozeilen-/ ToolTypes-Schnittstelle wurde so erweitert, da▀ eine
  134. m÷glichst vielfΣltige und flexible Verwendung von OberonPrefs in
  135. Stapelverarbeitungsdateien und ARexx-Skripten m÷glich ist.
  136.  
  137.  
  138.  
  139.                            Installationshinweise:
  140.                            ----------------------
  141.  
  142. Die Installation ⁿbernimmt das Installationsskript.  Es kopiert OberonPrefs
  143. und die Dokumentation ins OBERON:-Verzeichnis, und speichert die Kataloge
  144. aus dem catalogs-Verzeichnis ins LOCALE:-Verzeichnis, falls sie Workbench
  145. 2.1 oder h÷her installiert haben. Das Installationsskript installiert auf
  146. Wunsch auch die CygnusEd-ARexx-Skripte, mit denen Sie Amiga-Oberon
  147. komfortabel von CygnusEd aus steuern k÷nnen.
  148.  
  149. Falls Sie OberonPrefs hΣufig verwenden, sollten Sie in ihre S:User-Startup-
  150. Datei den Befehl 'resident Oberon:OberonPrefs' einbauen.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.              Die interaktive grafische Benutzerschnittstelle:
  157.              ------------------------------------------------
  158.  
  159.   -------
  160.   Gadgets
  161.   -------
  162.  
  163. Au▀er den Gadgets, mit denen die verschiedenen Compiler-/ Linker-Optionen
  164. eingestellt werden, und die hier nicht weiter beschrieben werden, da die
  165. Bedeutungen der einzelnen Optionen im Handbuch ersch÷pfend erklΣrt sind,
  166. sind normalerweise folgende Gadgets vorhanden:
  167.  
  168. Modus-Gadget - mit ihm wird der Operationsmodus eingestellt:
  169.   Global : die globalen Compiler-/ Linker-Optionen werden verΣndert.
  170.   Projekt: Projekt-/ Oberon-Quelltext-Modul-spezifische Optionen werden
  171.     verΣndert.
  172.   *1* 
  173.  
  174. Projekt-Anzeige-Gadget - Im Projekt-Modus wird hier der Name des gerade
  175.   manipulierten Oberon-Quelltext-Moduls angezeigt. Falls der Gadget-Name
  176.   ein unterstrichenes Zeichen enthΣlt, wirkt ein Druck auf die entsprechende
  177.   Taste wie die  Aktivierung des Datei-Gadgets.
  178.  
  179. Datei-Gadget - falls es aktiviert wird, erscheint ein
  180.   Datai-Auswahl-Eingabefeld (Filerequester), in dem ein neues Projekt 
  181.   ausgewΣhlt werden kann. Wenn die Eingabe bestΣtigt wird, versucht
  182.   OberonPrefs, das Projekt zu ÷ffnen. Wird die selektierte Datei als
  183.   Oberon-Quelltext-Modul erkannt, dann springt OberonPrefs in den Projekt-
  184.   Modus und liest die zum Projekt geh÷rigen Optionen gemΣ▀ den
  185.   Einstellungen im Einstellungen-Menⁿ ein.
  186.   *1*
  187.  
  188. Speichern-Gadget - Falls im Projekt-Modus kein Dateiname angegeben
  189.   ist, erscheint zuerst ein Datei-Auswahl-Eingabefeld (Filerequester), 
  190.   in dem das Projekt, fⁿr das die Optionen zu speichern
  191.   sind, eingegeben werden soll.  Existiert die Datei nicht oder
  192.   ist sie kein Oberon-Quelltext-Modul, so wird der Vorgang abgebrochen.
  193.   Andernfalls / anschlie▀end werden die eingestellten Optionen nach Ma▀gabe
  194.   der Einstellungen im Einstellungen-Menⁿ abgespeichert, _ohne_ OberonPrefs
  195.   zu verlassen (Konzeptions-Entscheidung, wegen der zwei Operationsmodi und
  196.   der M÷glichkeit, verschiedene Projekt-Einstellungen zu manipulieren!). 
  197.   Falls eines der Kommandozeilen-/ ToolTypes-Argumente OBERONOUT, OLINKOUT
  198.   oder OMAKEOUT angegeben wird, wird OberonPrefs dagegen nach dem
  199.   Abspeichern verlassen, da dann keine Umstellung des Operationsmodus /
  200.   des bearbeiteten Projektes m÷glich ist.
  201.   *2*
  202.  
  203. Abbrachen-Gadget - verlΣ▀t OberonPrefs ohne m÷gliche ─nderungen
  204.   abzuspeichern.
  205.   *1*
  206.  
  207. Benutzen-Gadget - Beendet OberonPrefs, ohne die gewΣhlten Optionen zu
  208.   speichern, gibt die gewΣhlten Optionen aber entsprechend des
  209.   vorhandenen #?OUT-Argumentes aus.
  210.   *3*
  211.  
  212. Schlie▀-Gadget - Funktion entspricht derjenigen des Abbrechen-Gadgets.
  213.   TastaturΣquivalent: ESC-Taste
  214.  
  215. ZoomGadget - verkleinert ('iconify') das Fenster von OberonPrefs resp.
  216.   setzt es zurⁿck auf seine ursprⁿngliche Gr÷▀e.
  217.   TastaturΣquivalent: 'Z'-Taste
  218.  
  219.  
  220. Alle Gadgets, deren Titel ein unterstrichenes Zeichen aufweisen, k÷nnen
  221. auch durch einen Druck auf die entsprechende Taste betΣtigt werden.
  222.  
  223.  
  224.  
  225. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  226.        oder OMAKEOUT beim Programmstart ⁿbergeben wird.
  227.  
  228. *2* :  Ist nicht vorhanden, falls eine der Optionen OBERONOUT, OLINKOUT oder
  229.        OMAKEOUT in Verbindung mit NOSAVEGAD beim Programmstart ⁿbergeben 
  230.        werden.
  231.  
  232. *3* :  Ist nur vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  233.        oder OMAKEOUT beim Programmstart ⁿbergeben wird.
  234.  
  235.  
  236.   -----
  237.   Menⁿs
  238.   -----
  239.  
  240. Projekt-Menⁿ:
  241.   
  242.   Neu - Setzt die Optionen auf die programminternen ('Default') Werte
  243.     von Amiga-Oberon zurⁿck und l÷scht den Projektnamen, falls der
  244.     Projekt-Modus aktiv ist. 
  245.     *1*
  246.  
  247.   ╓ffnen... - Die Funktion entspricht derjenigen des Datei-Gadgets. 
  248.     *1*
  249.   
  250.   Speichern Als... - ╓ffnet ein Datei-Auswahl-Eingabefeld (Filerequester),
  251.    speichert, wenn der Name eines existierenden Oberon-Quelltext-Moduls
  252.     eingegeben wurde, die eingestellten Optionen als Projekt-Optionen
  253.     dieses Projektes und springt in den Projekt-Modus falls der globale
  254.     Modus aktiv ist.
  255.     *1*
  256.  
  257.   Global Speichern - Speichert die eingestellten Optionen als globale
  258.     Voreinstellungen und springt in den globalen Modus, falls der
  259.     Projekt-Modus aktiv ist.
  260.     *1*
  261.     
  262.   Information... - ╓ffnet ein Informations-Fenster mit Angaben ⁿber  
  263.     OberonPrefs. 
  264.       In der letzten Zeile wird dabei der Code fⁿr die gegenwΣrtigen
  265.       Programm-Einstellungen im Einstellungen-Menⁿ angezeigt, der
  266.       nach ENVARC:OberonPrefs.prefs als Ganzzahl-String geschrieben
  267.       bzw. als SETTINGS/N/K-Argument beim Programmstart ⁿbergeben
  268.       werden kann, um die gegenwΣrtigen Programm-Einstellungen wieder
  269.       zu erhalten.
  270.       *1*
  271.  
  272.   Beenden - Die Funktion entspricht derjenigen des Abbrechen-Gadgets.
  273.   
  274. Vorgaben-Menⁿ:  
  275.  
  276.   Auf Vorgaben Zurⁿcksetzen - setzt die Optionen auf die programminternen
  277.     ('Default') Werte von Amiga-Oberon zurⁿck.
  278.     
  279.   Auf Zuletzt Global Gespeichertes - setzt die Optionen auf die zuletzt
  280.     gespeicherten globalen Voreinstellungen (bzw. auf die programminternen
  281.     'Default'-Voreinstellungen des Amiga-Oberon-Systems, falls keine
  282.     globalen Voreinstellungen existieren).
  283.     
  284.   Voreinstellungen Von Projekt... - ÷ffnet ein Datei-Auswahl-Eingabefeld,  
  285.     und, liest, falls der Name eines existierenden Oberon-Quelltext-Moduls
  286.     eingegeben wurde, die Voreinstellungen aus diesem Projekt ohne
  287.     den Modus und / oder den Projektnamen zu Σndern.
  288.     
  289.   Neu Einlesen - liest die Optionen neu ein (='Restore'-Funktion)
  290.   
  291. Einstellungen-Menⁿ:
  292.  
  293.   Piktogramme Erzeugen? - falls aktiv erzeugt OberonPrefs Piktogramme     
  294.     fⁿr Projekte, die keine Piktogramme besitzen. Die Piktogramm-Daten
  295.     werden dabei aus OBERON:Icons/txt.info zu lesen versucht, Falls das
  296.     nicht klappt, werden die Daten des Default-System-Projekt-Piktogramms
  297.     verwendet.
  298.     *1*
  299.  
  300.   Vorgaben-Optionen Speichern?  - falls aktiv werden beim Speichern der
  301.     Voreinstellungen auch diejenigen Optionen abgespeichert, die den
  302.     programminternen ('Default') Voreinstellungen von Amiga-Oberon
  303.     entsprechen.
  304.     *1*
  305.  
  306.   Projekt-Einstellungen Lesen-Untermenⁿ:
  307.     Die Einstellungsm÷glichkeiten dieses Untermenⁿs beeinflussen, wie    
  308.     OberonPrefs beim Einlesen der Voreinstellungen von Projekten vorgeht.
  309.     ZunΣchst kann der Benutzer zwischen vier verschiedenen Arten wΣhlen:        
  310.  
  311.       Modul & Prefs - falls aktiv liest OberonPrefs die Voreinstellungen
  312.         zuerst aus einer m÷glicherweise von OberonPrefs angelegten Kopf-
  313.         zeile am Anfang des Oberon-Quelltext-Moduls. Dabei werden
  314.         vorhandene, mit den Schlⁿsselworten OberonOpts / OLinkOpts versehene
  315.         Buchstaben-Optionen (entsprechen den Kommandozeilen-Optionen nach
  316.         '-') gelesen. Danach versucht OberonPrefs, Oberon.prefs-/
  317.         OLink.prefs-Voreinstellungsdateien heranzuziehen. Schlie▀lich werden
  318.         auch von OberonPrefs geschriebene Quelltextoptionen ($Option(+|-))
  319.         aus einer vorhandenen OberonPrefs-Kopfzeile aus dem
  320.         Oberon-Quelltext-Modul berⁿcksichtigt.
  321.         
  322.       Modul (Ohne Buchst.-Optionen) & Prefs - entspricht aktivem
  323.         'Modul & Prefs' mit der Ausnahme, da▀ die hinter den Schlⁿsselworten
  324.         OberonOpts / OLinkOpts folgenden Buchstaben-Optionen beim Einlesen
  325.         ignoriert werden. Dies ist die programminterne ('Default')
  326.         Einstellung von OberonPrefs, da sie der normalen Vorgehensweise des
  327.         Amiga-Oberon-Systems entspricht.
  328.         
  329.       Nur Modul - berⁿcksichtigt nur die Informationen aus einer OberonPrefs-
  330.         Kopfzeile am Anfang des Oberon-Quelltext-Moduls, einschlie▀lich 
  331.         Buchstabenoptionen und Quelltextoptionen.
  332.         
  333.       Nur Prefs - berⁿcksichtigt nur Informationen aus den Oberon.prefs /  
  334.         OLink.prefs - Voreinstellungsdateien.
  335.         
  336.     Weiterhin steht noch ein Schalter zur Verfⁿgung, der festlegt, wie die
  337.     (Oberon|OLink).prefs- Voreinstellungsdateien eingelesen werden:
  338.     
  339.       Prefs: Global Lesen M÷glich? - falls aktiv versucht OberonPrefs bei
  340.         nicht vorhandenen Voreinstellungsdateien im Projekt-Verzeichnis,
  341.         die globalen Voreinstellungsdateien im Verzeichnis OBERON: zu lesen.
  342.         Dies entspricht der programminternen ('Default') Einstellung von
  343.         OberonPrefs, da auch das Amiga-Oberon-System so vorgeht.
  344.         
  345.   Projekt-Einstellungen Schreiben-Untermenⁿ:
  346.     Mit den Menⁿpunkten dieses Untermenⁿs kann der Benutzer festlegen, wie
  347.     OberonPrefs beim Schreiben von Projekt-Voreinstellungen vorgeht. Folgende
  348.     Schalter sind vorhanden:
  349.     *1*
  350.     
  351.       Stapelbare Optionen Als Quelltext? - falls aktiv schreibt OberonPrefs
  352.         auch diejenigen Optionen, die ⁿber Buchstaben-Optionen in der
  353.         Kommandozeile und die Voreinstellungsdateien eingestellt werden
  354.         k÷nnen und auch als Quelltext-Optionen dem Amiga-Oberon-System
  355.         bekannt sind, als Quelltextoptionen in die OberonPrefs-Kopfzeile des
  356.         Oberon-Quelltext-Moduls. Dies entsprach bis OberonPrefs 1.9 der 
  357.         programminternen Voreinstellung von OberonPrefs. In den neueren
  358.         Versionen von OberonPrefs ist die programminterne Voreinstellung,
  359.         dies zu unterlassen.
  360.         *1*
  361.         
  362.       Buchstaben-Optionen Schreiben? - falls aktiv schreibt OberonPrefs
  363.         die Buchstaben-Optionen fⁿr den Compiler- / Linker-Aufruf in die
  364.         OberonPrefs-Kopf-Zeile des Oberon-Quelltext-Moduls. Frⁿher war dies
  365.         programminterne Voreinstellung bis OberonPrefs 1.9; in den neueren
  366.         Programmversionen von OberonPrefs ist dieser Menⁿpunkt dagegen
  367.         aufgrund der programminternen Voreinstellung von OberonPrefs
  368.         deaktiviert.
  369.         *1*
  370.         
  371.     Weiterhin kann mit diesem Untermenⁿ eine von vier Arten ausgewΣhlt werden,    
  372.     wie OberonPrefs (Oberon|OLink).prefs-Voreinstellungsdateien beim Speichern
  373.     behandelt:
  374.       
  375.       Prefs Mit Optionen Schreiben - falls aktiv schreibt OberonPrefs
  376.         die Voreinstellungsdateien mit den gewΣhlten Optionen ins Projekt-
  377.         Verzeichnis. (Programminterne Voreinstellung von OberonPrefs)
  378.         *1*
  379.         
  380.       Leere Optionen Schreiben - falls aktiv schreibt OberonPrefs leere  
  381.         Voreinstellungsdateien ins Projekt-Verzeichnis. Dies ist nⁿtzlich,
  382.         wenn das Amiga-Oberon-System ohne Berⁿcksichtigung der
  383.         (Oberon|OLink).prefs- Voreinstellungsdateien arbeiten soll, da
  384.         so verhindert wird, da▀ irgendwelche Informationen aus den
  385.         Voreinstellungsdateien, auch nicht aus den globalen im OBERON:- 
  386.         Verzeichnis, verwendet werden.
  387.         *1*
  388.         
  389.       Keine Prefs Schreiben - falls aktiv ignoriert OberonPrefs vorhandene
  390.         (Oberon|OLink).prefs- Voreinstellungsdateien im Projekt-Verzeichnis
  391.         und schreibt auch keine Voreinstellungsdateien. Nⁿtzlich, falls
  392.         nur die Optionen eines Oberon-Quelltext-Moduls im Projekt-Verzeichnis
  393.         geΣndert wurden, und diese ─nderungen nicht fⁿr die anderen
  394.         Oberon-Quelltext-Module im Projekt-Verzeichnis gelten sollen.
  395.         *1*
  396.         
  397.       Prefs L÷schen - falls aktiv, l÷scht OberonPrefs vorhandene  
  398.         Voreinstellungsdateien im Projektverzeichnis, und schreibt keine
  399.         solchen zurⁿck.
  400.         *1*
  401.         
  402.     Schlie▀lich kann hier noch der Modus eingestellt werden, wie OberonPrefs   
  403.     Options-ToolTypes von Projekt-Piktogrammen handhaben soll:
  404.       
  405.       ToolTypes Schreiben - falls aktiv schreibt OberonPrefs die aktuellen
  406.         Optionen als ToolTypes in die Projekt-Piktogramme. Dies war
  407.         bis einschlie▀lich OberonPrefs 1.9 grundsΣtzlich der Fall. Falls 
  408.         beim Programmstart ein 'alter' SETTINGS-Wert von OberonPrefs <= 
  409.         V1.9 als SETTINGS/N/K-Argument ⁿbergeben wird oder aus 
  410.         ENVARC:OberonPrefs.prefs gelesen wird, ist dies aus KompatibilitΣts-
  411.         grⁿnden auch bei neueren OberonPrefs-Versionen die Voreinstellung.
  412.         *1*
  413.         
  414.       ToolTypes Ignorieren - falls aktiv ignoriert OberonPrefs eventuell 
  415.         bestehende Options-ToolTypes in Projekt-Piktogrammen und schreibt
  416.         auch keine eigenen ToolTypes. (Programminterne Voreinstellung von 
  417.         OberonPrefs ab OberonPrefs 1.10)
  418.         *1*
  419.         
  420.       ToolTypes L÷schen - falls aktiv l÷scht OberonPrefs eventuell bereits
  421.         bestehende Options-ToolTypes in Projekt-Piktogrammen, schreibt jedoch
  422.         keine eigenen ToolTypes in die Projekt-Piktogramme zurⁿck.
  423.         *1*
  424.         
  425.   Einstellungen Speichern  - dieser Menⁿpunkt speichert die im Einstellungen-
  426.     Menⁿ von OberonPrefs gemachten Einstellungen ab, so da▀ sie bei jedem
  427.     zukⁿnftigen Programmstart von OberonPrefs wieder gesetzt werden. (Das  
  428.     Kommandozeilen-/ ToolTypes-Argument SETTINGS/N/K ⁿberschreibt diese
  429.     Einstellungen)
  430.     *1*
  431.  
  432.  
  433.  
  434. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  435.        oder OMAKEOUT beim Programmstart ⁿbergeben wird.
  436.  
  437.  
  438.         
  439.   -----------------------------------------
  440.   Piktogramm-Ziehen ins OberonPrefs-Fenster
  441.   -----------------------------------------
  442.  
  443. Weiterhin k÷nnen in das OberonPrefs-Fenster Piktogramme gezogen werden. 
  444.   Die Funtion entspricht dabei der des Datei-Gadgets.
  445.   *1*
  446.   
  447.  
  448. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  449.        oder OMAKEOUT beim Programmstart ⁿbergeben wird.
  450.  
  451.  
  452.  
  453.  
  454.                   Kommandozeilen- / ToolTypes-Argumente:
  455.                   --------------------------------------
  456.  
  457.  
  458. Die Argument-Schablone von OberonPrefs lautet:
  459.  
  460. FROM,TO=FILE,OBERONOPTS/K,OLINKOPTS/K,EDIT/S,USE=SAVE/S,OBERONOUT/S,
  461. OLINKOUT/S,OMAKEOUT/S,GLOBAL/S,LOCAL/S,PUBSCREEN/K,NOGUI/S,NOSAVEGAD/S,
  462. SETTINGS/N/K,
  463. NoStackChk=S/S,NoOvflChk=V/S,NoRangeChk=B/S,NoCaseChk=C/S,NoReturnChk=R/S,
  464. NoNilChk=N/S,OddChk=O/S,NoTypeChk=T/S,SmallCode=M/S,SmallData=D/S,
  465. NoImplementation/S,NoGarbageCollector=A/S,NoExtensions=E/S,Debug=G/S,
  466. NoClearVars=Z/S,Icons=I/S,NoNewSymbols=Y/S,Small/S,mc68881=8/S,
  467. NoAutoRegPars=P/S,CodeChip/S,DataChip/S,VarsChip/S,mc68030=3/S,
  468. mc68020=2/S,mc68010=1/S
  469.  
  470. Die Argumente im einzelnen:
  471.  
  472. FROM - Dateiname des Projektes, dessen Voreinstellungen eingelesen werden
  473.   sollen. Es existieren zwei spezielle Namen, sogenannte 'Magics':
  474.     Global - liest die globalen Voreinstellungen ein. (Voreinstellung, falls
  475.       dieses Argument ausgelassen wird)
  476.     Default - liest die programminternen Voreinstellungen des Amiga-Oberon-
  477.       Systems ein.
  478.   Die Verwendung der Schalter LOCAL/S u./o. USE=SAVE/S bewirkt, da▀ bei
  479.   nicht vorhandenem TO=FILE-Argument, und falls das FROM-Argument kein 
  480.   'Magic' ist, das FROM-Argument als TO=FILE-Argument ⁿbernommen wird.
  481.  
  482. TO=FILE - Dateiname des Projektes, das bearbeitet werden soll. Die Angabe
  483.   dieses Argumentes impliziert den Schalter LOCAL/S, und schlie▀t die
  484.   Benutzung des Schalters GLOBAL/S aus.
  485.   
  486. OBERONOPTS/K,OLINKOPTS/K - siehe weiter unten.
  487.  
  488. EDIT/S - Schalter, der angibt, da▀ OberonPrefs im interaktiven Modus  
  489.   arbeiten soll. Da dies die programminterne ('Default') Einstellung
  490.   von OberonPrefs ist, kann er immer weggelassen werden. Die Verwendung
  491.   von EDIT/S schlie▀t diejenige der Schalter USE=SAVE/S und NOGUI/S
  492.   aus.
  493.  
  494. USE=SAVE/S - Schalter, der angibt, da▀ OberonPrefs die gelesenen
  495.   Voreinstellungen speichern soll, ohne die interaktive Benutzer-
  496.   schnittstelle zu aktivieren. Schlie▀t die Verwendung von EDIT/S aus,
  497.   und setzt voraus, da▀ bei aktivem Projekt-Modus ein existierender
  498.   Projektname als TO=FILE-Parameter angegeben ist (der auch vom FROM-
  499.   Parameter ⁿbernommen werden kann, s.o.)
  500.   
  501. OBERONOUT/S  
  502. OLINKOUT/S  
  503. OMAKEOUT/S  - Diese Schalter schlie▀en sich gegenseitig aus, und bewirken,
  504.   da▀ OberonPrefs bei ordnungsgemΣsser Beendigung den Kommandozeilen-
  505.   Optionsstring mit den Buchstabenoptionen fⁿr Oberon / OLink / OMake
  506.   ausgibt. Diese Argumente sind Σu▀erst wichtig fⁿr die Verwendung von
  507.   OberonPrefs in Stapelverarbeitungsdateien und ARexx-Skripten.
  508.   Die grafische Benutzerschnittstelle von OberonPrefs wird durch diese
  509.   Argumente au▀erdem verΣndert:
  510.     Es ist nicht mehr m÷glich, den Operations-Modus (Global / Projekt)
  511.     zu Σndern, au▀erdem kann kein anderes Projekt als das angegebene 
  512.     verΣndert werden, und die Einstellm÷glichkeiten im Einstellungen-
  513.     Menⁿ sind auf die Menⁿpunkte des Untermenⁿs 'Projekt-Voreinstel-
  514.     lungen lesen' beschrΣnkt. Anstelle des 'Abbrechen'-Gadgets 
  515.     erscheint ein 'Benutzen'-Gadget (Die Funktion des Abbrechen-Gadgets
  516.     kann natⁿrlich weiterhin mit dem Schlie▀-Gadget und dem Menⁿpunkt
  517.     'Projekt->Beenden' erreicht werden), resp. bei angegebenem NOSAVEGAD/S-
  518.     Schalter wird das 'Speichern'-Gadget durch ein 'Benutzen'-Gadget
  519.     ersetzt. In diesem Fall kann die Funktion Speichern nicht mehr
  520.     erreicht werden.
  521.  
  522. GLOBAL/S - Dieser Schalter setzt den globalen Operationsmodus 
  523.   (Voreinstellung von OberonPrefs). Inkompatibel mit den Argumenten 
  524.   TO=FILE und LOCAL/S.
  525.   
  526. LOCAL/S - Dieser Schalter setzt den Projekt-Operationsmodus. Inkompatibel  
  527.   mit GLOBAL/S. Wird automatisch gesetzt bei angegebenem TO=FILE-Argument
  528.   oder bei angebenem Nicht-'Magic'-FROM-Argument und angegebenem
  529.   USE=SAVE/S-Schalter.
  530.   
  531. PUBSCREEN/K - Hier kann der Name des ÷ffentlichen Schirms angegeben werden,  
  532.   auf dem das Fenster der grafischen Benutzerschnittstelle ge÷ffnet werden
  533.   soll. Falls der angegebene Schirm nicht existiert, wird auf den System-
  534.   Default-Schirm ausgewichen (was die programminterne Voreinstellung von
  535.   OberonPrefs ist).
  536.   
  537. NOGUI/S - Dieser Schalter ist nur sinnvoll bei Verwendung einer der Schalter
  538.   OBERONOUT/S, OLINKOUT/S oder OMAKEOUT/S. Er bewirkt, da▀ bei nicht
  539.   gesetztem USE=SAVE/S-Schalter die grafische Benutzerschnittstelle trotzdem
  540.   nicht ge÷ffnet wird, sondern nur die jeweiligen Voreinstellungen eingelesen
  541.   werden und entsprechend dem angegebenen #?OUT/S-Schalters der Optionsstring
  542.   ausgegeben wird. Weiterhin ist die Verwendung dieses Schalters immer dann
  543.   erlaubt (aber ohne Auswirkung), wenn zugleich der USE=SAVE/S-Schalter
  544.   angegeben wird.
  545.  
  546. NOSAVEGAD/S - Dieser Schalter ist nur bei angegebenm #?OUT/S-Schalter und bei
  547.   Verwendung der grafischen Benutzerschnittstelle erlaubt. Seine Auswirkungen
  548.   sind in der Dokumentation der #?OUT/S-Schalter beschrieben.
  549.   
  550. SETTINGS/N/K - Hier wird die Angabe einer gⁿltigen Dezimalzahl erwartet, die
  551.   dekodiert gⁿltige Einstellungen im Einstellungen-Menⁿ von OberonPrefs
  552.   liefert. 
  553.     Die gewⁿnschte Zahl kann leicht ermittelt werden, indem man
  554.     innerhalb der grafischen Benutzerschnittstelle die Einstellungen auf den
  555.     gewⁿnschten Wert Σndert und dann das Informationsfenster mit dem Menⁿ-
  556.     punkt Projekt->Information... ÷ffnet. In der letzten Zeile dieses
  557.     Fensters ist dann der Code fⁿr die gegenwΣrtigen Einstellungen zu
  558.     finden.
  559.     *1*
  560.  
  561.  
  562. Die restlichen Argumente dienen dazu, einzelne Compiler-/ Linker-Optionen zu 
  563. setzen/l÷schen:
  564.  
  565. OBERONOPTS/K: - erwartet die Angabe eines gⁿltigen Optionsstrings fⁿr
  566.   den Oberon-Compiler, bestehend aus einem optionalen '-', gefolgt von den
  567.   einzelnen Buchstaben-Optionen.
  568.     
  569. OLINKOPTS/K: - erwartet die Angabe eines gⁿltigen Optionsstrings fⁿr OLink,
  570.   bestehend aus einem optionalen '-', gefolgt von den einzelnen Buchstaben-
  571.   Optionen.
  572.  
  573. NoStackChk=S/S,NoOvflChk=V/S,NoRangeChk=B/S,NoCaseChk=C/S,NoReturnChk=R/S,
  574. NoNilChk=N/S,OddChk=O/S,NoTypeChk=T/S,SmallCode=M/S,SmallData=D/S,
  575. NoImplementation/S,NoGarbageCollector=A/S,NoExtensions=E/S,Debug=G/S,
  576. NoClearVars=Z/S,Icons=I/S,NoNewSymbols=Y/S,Small/S,mc68881=8/S,
  577. NoAutoRegPars=P/S,CodeChip/S,DataChip/S,VarsChip/S,mc68030=3/S,
  578. mc68020=2/S,mc68010=1/S - setzt / l÷scht jeweils eine einzelne Option.
  579.  
  580.  
  581.  
  582. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  583.        oder OMAKEOUT beim Programmstart ⁿbergeben wird.
  584.  
  585.  
  586.  
  587.   Benutzerdefinierbare interaktive Argument-Abfrage beim Programmstart:
  588.   ---------------------------------------------------------------------
  589.  
  590. OberonPrefs bietet Ihnen beim Workbench-Start in Verbindung mit ToolTypes-
  591. Argumenten die M÷glichkeit, sich einzelne, mehrere oder alle Argumente 
  592. durch interaktive Argument-Eingabefenster ('Argument-Requester') zu
  593. beschaffen, falls Sie in Ihrem System die reqtools.library Version 38 oder
  594. h÷her istalliert haben. Dazu mⁿssen Sie fⁿr die Argumente, fⁿr die solche
  595. Eingabe-Fenster erscheinen sollen, gⁿltige ToolType-EintrΣge anlegen, deren
  596. Namen Sie ein 'ASK:' vorstellen mⁿssen. Also etwa 'Ask:Settings=971', o.Σ.
  597.  
  598.  
  599.                        Programmende & Rⁿckgabewerte
  600.                        ----------------------------
  601.  
  602. Falls OberonPrefs mittels des Speichern-Gadgets, des Benutzen-Gadgets oder
  603. durch die entsprechenden TastaturΣquivalente verlassen wird, terminiert
  604. OberonPrefs mit einem Rⁿckgabewert 0 (OK).  Wenn die grafische
  605. Benuzterschnittstelle aufgrund der ⁿbergebenen Argumente nicht ge÷ffnet
  606. wird, und OberonPrefs ordnungsgemΣ▀ terminiert, wird ebenfalls 0
  607. zurⁿckgegeben.  Im anderen Fall, falls OberonPrefs durch den
  608. Projekt->Beenden-Menⁿpunkt, durch das Schlie▀gadget, durch Drⁿcken der
  609. ESC-Taste, durch das Cancel-Gadget oder das zugeh÷rige TastaturΣquivalent
  610. beendet wird, liefert es den Rⁿckgabewert 5 (WARN).  In allen anderen
  611. FΣllen - wenn also OberonPrefs aufgrund fehlerhafter Argumente oder
  612. aufgrund von fⁿr OberonPrefs ungenⁿgenden System-Ressourcen terminiert,
  613. liefert es den Rⁿckgabewert 20 (FAIL), gibt, wenn nicht einer der Schalter
  614. OBERONOUT/S, OLINKOUT/S oder OMAKEOUT/S spezifiziert wurde, eine
  615. entsprechende Meldung auf dem aktuellen Ausgabekanal aus und lΣ▀t zusΣtlich
  616. den Bildschirm aufflackern, falls es von der Workbench aus gestartet wurde.
  617.  
  618.  
  619.  
  620.                    Allgemeine Hinweise zum Programm
  621.                    --------------------------------
  622.  
  623. Als gⁿltige Projekte werden nur solche Projekte erkannt, deren Namen
  624. auf '.mod' endet und die keine BinΣrdaten enthalten.  OberonPrefs hat
  625. aber wie der Amiga-Oberon-Compiler die FΣhigkeit, das '.mod'-Suffix
  626. automatisch an einen spezifizierten Dateinamen anzuhΣngen und
  627. au▀erdem, falls das Oberon-Quelltext-Modul im angegebenen Verzeichnis
  628. nicht gefunden werden konnte, im Unterverzeichnis 'txt' nach ihm zu
  629. suchen.
  630.  
  631.  
  632. Durch das Konvertieren von Projekt-Voreinstellungen nach globalen
  633. Voreinstellungen, oder dem Nur-Einlesen der #?.prefs-Voreinstellungs-
  634. dateien bei Projekten gehen m÷gliche CodeChip+, DataChip+, VarsChip+
  635. und Implementation- - Einstellungen verloren, da diese nur in
  636. Oberon-Quelltext-Moduen gespeichert werden k÷nnen.
  637.  
  638.  
  639. Eine Bemerkung zum verwendeten ToolTypes-Parsing:  Es wird das mΣchtige
  640. ToolTypes-Parsing aus BlackMagic verwendet, das AmigaDOS-ReadArgs()-
  641. Schablonen ersch÷pfend unterstⁿtzt und das geniale 'Argument-Request'
  642. bietet.
  643.  
  644.  
  645.  
  646.  
  647.                  ----------------------------------------
  648.                  Vermeiden des VerΣnderns des Quelltextes 
  649.                  d.h. Anlegen/─ndern der OPREFS-Kopfzeile
  650.                  ----------------------------------------
  651.  
  652. Falls Sie das Schreiben von OPREFS-Kopfzeilen auf Dauer vermeiden wollen,
  653. sollten Sie die Menⁿpunkte
  654.  
  655. * Einstellungen->Vorgaben-Optionen╖Speichern?
  656.  
  657. sowie
  658.  
  659. * Einstellungen->Projekt-Einstellungen╖Schreiben->Stapelbare╖Optionen╖
  660.                                                   Als╖Quelltext?
  661.  
  662. und                                            
  663.  
  664. * Einstellungen->Projekt-Einstellungen╖Schreiben->Buchstaben-Optionen╖
  665.                                                   Schreiben?
  666.  
  667. deaktivieren und diese Einstellungen mit Hilfe des Menⁿpunktes
  668.  
  669. * Einstellungen->Einstellungen╖Speichern
  670.  
  671. fⁿr Ihr System als Voreinstellungen abspeichern.
  672.  
  673.  
  674.         * Ab OberonPrefs  1.10  entspricht dies  den  programm-  *
  675.         * internen Voreinstellungen ('Defaults') von OberonPrefs *
  676.  
  677.  
  678.  
  679.  
  680.                           Entwicklungsgeschichte
  681.                           ----------------------
  682.  
  683.   v1.0 [fSchwarz] 28.6.93  First fully functional version
  684.  
  685.   v1.1 [fSchwarz] 4.7.93  Removed stupid bug in argument
  686.     processing order: processed SETTINGS after FROM & TO
  687.  
  688.   v1.2 [fSchwarz] 6.7.93  Added display clip sensitivity
  689.     when rendering x/y positions, pr.windowPtr redirection
  690.  
  691.   v1.3 [fSchwarz] 6.7.93  Added warning requester for
  692.     filenames not ending in '.mod', changed requester code
  693.  
  694.   v1.4 [fSchwarz] 9.7.93  Added 'OberonPrefs failed' msg &
  695.     Int.DisplayBeep() in case of failure, Dos.IoErr support
  696.  
  697.   v1.5 [fSchwarz] 16.7.93  Fixed Asl.save-Flag FReq bug
  698.  
  699.   v1.6 [fSchwarz] 17.7.93  Removed ~'.mod' warn requester,
  700.     adapted filename handling to Oberon's (add missing
  701.     '.mod' suffix, search in 'txt' subdirectory)
  702.  
  703.   v1.7 [fSchwarz] 21.7.93  Adapted to new BlackMagic layout
  704.  
  705.   v1.8 [fSchwarz] 14.8.93  Recompiled with BlackMagic 1.10:
  706.     now argument requesters may pop up if wbstarted
  707.  
  708.   v1.9 [fSchwarz] 9.9.93  fixed mc680x0 option management
  709.     due to very strange compiler feature: Enabling 68030
  710.     instruction generation does NOT imply generation of
  711.     68020/68010 instructions, etc.
  712.  
  713.   v1.10 [fSchwarz] 10.9.93  Added user control of Project-
  714.     ToolTypes writing via Settings menu; changed default
  715.     settings so that usually no source writes are needed.
  716.  
  717.   v1.11 [fSchwarz] 13.9.93  Minor cosmetic code changes,
  718.     now works well with a NIL Asl.base, added
  719.     complete English docs, corrected German docs, updated
  720.     strings.
  721.  
  722.   v1.11a [fSchwarz] 17.9.93 Added Busypointer & window
  723.     blocking during writing / reading operations (suggested
  724.     by Christian Stiens)
  725.  
  726.   v1.11b [fSchwarz] 18.9.93 now also locked GUI during
  727.     ValidateFName() due to packing filesys like XFH, etc.
  728.  
  729.   v1.11c [fSchwarz] 18.9.93 DisplayBeeps if ValidateFName()
  730.     fails in interactive mode.
  731.  
  732.   v1.11d [fSchwarz] 20.9.93 Now writes OLink.prefs options
  733.     in complete upper case.
  734.  
  735.   v1.11e [fSchwarz] 30.9.93 Now uses smartRefresh window,
  736.     adapted to Hartmut Goebel's OS3.0-interface modules,
  737.     removed FReq-Hook (due to frequently used braindead
  738.     broken ASL-patches)
  739.  
  740.   v2.0 [fSchwarz] 8.10.93 Enhanced window locking with
  741.     new BlackMagic1.12. Improved AppWindow icon dropping
  742.     feature: Project-FileRequester pops up if the dropped
  743.     icon is no valid Oberon source code module. Since no
  744.     bugs showed up despite deep, thoroughgoing testing,
  745.     debug code defaults to off, all runtime code checks
  746.     are disabled, so maximum performance is guaranteed and
  747.     minimum code size is ensured. Thus, as this version is
  748.     considered to be 'final', major revision count has been
  749.     incremented to 2.
  750.  
  751.  
  752.  
  753.  
  754.                              Schlu▀bemerkungen
  755.                              -----------------
  756.  
  757. Der komplette Quelltext von OberonPrefs1.11d ist auf Amok#95 zu finden.
  758.  
  759. Bugs (Programmfehler):  Zum Zeitpunkt des Verfassens dieser Dokumentation
  760. sind dem Autor keinerlei Fehlfunktionen dieses Programms bekannt.  Bei dem
  761. Umfang dieses Programms ist jedoch der eine oder andere Bug grundsΣtzlich
  762. nicht auszuschlie▀en!
  763.  
  764. OberonPrefs ist Giftware.  Das hei▀t, ich ermuntere Sie, mir, falls Sie
  765. sich fⁿr das Programm begeistern k÷nnen, als Anerkennung ein kleines
  766. Geschenk, eine Spende, eine nette Postkarte, o.Σ.  zukommen zu lassen.
  767. Auch jedwede Kritik, ─nderungsvorschlΣge, natⁿrlich Bugreports
  768. (Fehlerberichte), etc. sind herzlich willkommen.
  769.  
  770. Falls Sie die deutsche Dokumentation in andere Sprachen ⁿbersetzen, oder
  771. Katalog-Dateien fⁿr andere Sprachen als Deutsch erstellen, so k÷nnen Sie
  772. diese gerne diesem Archiv hinzufⁿgen und mir zusenden. Vielen Dank!
  773.  
  774. OberonPrefs ist urheberrechtlich geschⁿtzt. Copyright ⌐ 1993 Franz Schwarz.
  775.  
  776. Der Autor haftet fⁿr keinerlei SchΣden, die unmittelbar oder mittelbar, vom
  777. Gebrauch dieses Programms herrⁿhren.
  778.  
  779. OberonPrefs ist frei kopierbar; es darf auf der Amok-Serie und auf anderen
  780. nicht-kommerziellen Disketten-Serien vertrieben werden, inklusive
  781. CD-ROM-Versionen derselben, ebenfalls darf es auf dem Weg der
  782. elektronischen Datenⁿbertragung verbreitet werden.
  783.  
  784. OberonPrefs darf nur in diesem Archiv komplett verbreitet werden.
  785. Weiterhin darf es nur verbreitet werden, falls der Vertreiber kein
  786. Urheberrecht auf das Archiv noch auf Dateien, die zwangsweise mit ihm
  787. ⁿbertragen werden, erhebt.  Anfragen auf Ausnahmen von diesen
  788. BeschrΣnkungen k÷nnen an den Autor gerichtet werden.
  789.  
  790.  
  791.  
  792.                     Sie erreichen mich folgenderma▀en:
  793.                     ----------------------------------
  794.  
  795.                                Franz Schwarz
  796.                    Mⁿhlenstra▀e 2, D-78591 Durchhausen,
  797.                               BR Deutschland
  798.                     Uucp: Franz_Schwarz@mil.ka.sub.org
  799.                     Fido: 2:2476/506.18 & 2:241/7506.18
  800.               Kto. 951.207 bei BLZ 643 500 70 KSK Trossingen
  801.  
  802.  
  803.  
  804.  
  805.  
  806.                            Credits, Danksagungen
  807.                            ---------------------
  808.  
  809. Die grafische Benutzerschnittstelle wurde erstellt mit Hilfe von
  810. GadToolsBox 37.176 by Jan van der Baard und Kai Bolay (Oberon source
  811. generator).  Ohne GadToolsBox hΣtte es wohl OberonPrefs nie gegeben.
  812. Einen galaktischen Donnergurgler-Toast auf die beiden;-)
  813. Die CygnusEd-Skripte benutzen Kai Bolay's oberonsupport.library, und
  814. Teile der Skripte stammen ebenfalls aus seiner Feder.
  815. Die reqtools.library, von der OberonPrefs Nutzen ziehen kann, wurde
  816. geschrieben von und ist urheberrechtlich geschⁿtzt durch Nico Franτois,
  817. jedoch frei vertreibbar, falls genau dies in der programmbegleitenden
  818. Dokumentation erwΣhnt wird.
  819.  
  820.  
  821.  
  822. Viel Spa▀!
  823.  
  824.   Franz 'Blacky' Schwarz.
  825.  
  826.  
  827.  
  828.                       Die CygnusEd - ARexx - Skripte
  829.                       ------------------------------
  830.  
  831.  
  832. Die CygnusEd-ARexx-Skripte erm÷glichen eine komfortable Steuerung des
  833. Amiga-Oberon-Systems von CygnusEd Professional aus. Die folgende
  834. Kurzanleitung geht davon aus, dass die beiliegende Funktionstasten-
  835. belegung in CyngusEd aktiviert ist.
  836.  
  837. F1 - Compile:  Ruft den Compiler auf. Falls das Modul verΣndert wurde
  838.   und noch nicht gespeichert ist, wird es vor dem Complieren gespeichert.
  839.   Zeigt den ersten Fehler an, falls Fehler beim Compilieren auftraten.
  840.   
  841. F2 - Link: Ruft den Linker auf.  
  842.  
  843. F3 - Make: Ruft OMake auf. Falls das Modul verΣndert wurde und noch nicht
  844.   gespeichert ist, wird es vor dem Aufruf von OMake gespeichert.
  845.  
  846. Compile, Link, als auch Make verwenden dabei folgende Compiler-/ Linker-
  847.   Optionen: falls von einem Aufruf von 'F7 - Change Temporary Options' her 
  848.   gⁿltige temporΣre Einstellungen existieren, werden diese verwendet.
  849.   Ansonsten werden die Optionen von OberonPrefs mit aktiviertem 
  850.   'Einstellungen->Projekt-Einstellungen Lesen->Modul & Prefs' und
  851.   'Einstellungen->Projekt-Einstellungen Lesen->Prefs: Global Lesen M÷glich?'
  852.   eingelesen.
  853.  
  854. F4 - First Error: Springt zum ersten Fehler
  855.  
  856. F5 - Next Error : Springt zum nΣchsten Fehler vom Cursor aus gesehen.
  857.  
  858. F6 - Prev. Error: Springt zum vorhergehenden Fehler vom Cursor aus gesehen.
  859.  
  860. F7 - Change Temporary Options: Setze / l÷sche temporΣre Optionen fⁿr ein
  861.   Modul. Falls das Modul verΣndert wurde und noch nicht gespeichert ist,
  862.   wird es vor dem Aufruf von OberonPrefs gespeichert.
  863.  
  864. F8 - Change Options: UnbeschrΣnktes Manipulieren von Optionen beliebiger
  865.   Projekte und der globalen Optionen mit OberonPrefs. Falls der gegenwΣrtig
  866.   edierte Text ein Oberon-Quelltext-Modul ist, das verΣndert wurde und noch
  867.   nicht gespeichert ist, wird es vor dem Aufruf von OberonPrefs gespeichert.
  868.   Wenn sie die Optionen des gegenwΣrtig edierten Moduls geΣndert und
  869.   gespeichert haben, sollten Sie das Modul mit dem CygnusEd-Menⁿpunkt
  870.   Project->Open... nach Beendigung von OberonPrefs neu einlesen.
  871.  
  872.  
  873. Falls Sie die ARexx-Skripte regelmΣ▀ig verwenden, ist dringend zu
  874. empfehlen, OberonPrefs mit 'Resident OBERON:OberonPrefs' resident in den
  875. Speicher zu laden.
  876.  
  877.  
  878. Fⁿr weitere Infos ⁿber die Rexx-Steuerung genⁿgt ein Blick auf die 
  879.   ARexx-Skripte.
  880.  
  881.  
  882.       Bye,
  883.         Franz 'Blacky' Schwarz
  884.  
  885.                - Girlfriend Is Better - Talking Heads -
  886.  
  887.